home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / satellit / im2gif / readme < prev    next >
Text File  |  1991-11-24  |  4KB  |  114 lines
  1. UoSAT-5 to GIF tools
  2. Version 2 (im files)
  3.  
  4. Disclaimer
  5.  
  6. There was no attempt to make these routines easily portable to anything.
  7. They are for MS-DOS and Microsoft C.
  8.  
  9. There was no attempt to make these routines easily adaptable to other
  10. raw CCD formats.
  11.  
  12. This stuff works on my system with the current image format, I'm sending
  13. it out as is to help others get started.  It isn't pretty, but there are
  14. only so many hours in the day.
  15.  
  16. There was no attempt to optimize this for speed, other than the usual.
  17. I suggest you use a big ramdisk and do the processing there.  Using
  18. a 1mb ramdisk and 2mb disk cache, on a 33MHz 486 it takes 10 seconds
  19. to go from a imnnnn file to a displayed pic on the screen.
  20.  
  21. That said, here's what's what.
  22.  
  23. These programs take a raw imnnnn file as output from PHS.  The format of
  24. this file is described in inter.c, which originally came from UoSAT.  There
  25. has been the addition of a 256 byte header since the inter documentation was
  26. done, but the current version of the source runs with the currect imnnnn 
  27. files.   The output of the programs is a flat "raster" file suitable to 
  28. use as input to RG8, which will convert the file to .GIF.
  29.  
  30. The programs:
  31.  
  32.  
  33.  
  34. inter  - merges the two fields into a single frame.
  35.  
  36. spec   - attempts to remove the "speckles" from the image, reduce the
  37.          horizontal white bar, and reduce the following horizontal black
  38.          bar.  (Anyone who comes up with a better way, which shouldn't
  39.          be too tough, is asked to send me the improved source).
  40.  
  41. clip   - remove black bar from the left of the image.
  42.  
  43. header - display image header
  44.  
  45.  
  46.  
  47. The files:
  48.  
  49. CLIP.C         Clip source and program
  50. CLIP.EXE
  51.  
  52. CONVERT.BAT    BAT file to do everything.  Say "convert imnnnn", e.g.
  53.                phs 1b5.dl /x
  54.                convert im0070
  55.  
  56. HEADER.C       display image header.  Use on an imnnnn file, not a .dl
  57.                file.
  58. HEADER.EXE
  59.  
  60. INTER.C        Interleave program
  61. INTER.EXE
  62.  
  63. SPEC.C         speckle program
  64. SPEC.EXE
  65.  
  66. STDPAL.PAL     null palette file
  67.  
  68. README         This file.
  69.  
  70.  
  71.  
  72. Convert explained
  73.  
  74.  
  75. inter %1a %1b
  76.        Take the two halves of the file in 611 byte lines and 
  77.        interleave, making 612 byte lines.
  78.  
  79. del %1a
  80. spec %1b %1c 60
  81.        Remove speckles by looking for bytes that are more than 20
  82.        different that adjacent bytes.  Too simple, but works well
  83.        for most images.  Identifies white bar by looking for values
  84.        in the "black level" area that are greater than 60.  If the
  85.        image has more than 6 white lines found, adjust the cutoff up,
  86.        80 usually works for me.
  87.  
  88. del %1b
  89. clip %1c %1d 0 44
  90.        Remove leftmost 44 bytes on each line, making 568 byte lines.
  91.  
  92. del %1c
  93. rg8 %1d. /c568 /r578 /ps
  94.        Convert raster to .GIF using 578 lines of 568 bytes.  Use /r480
  95.        to get a file that fits in 640x480.
  96.  
  97.  
  98.  
  99. rg8 is shareware which was on UO-14 a while ago, described thus:
  100.  
  101. RG8.ARC/binary            01-Sep-88 14791             Accesses: 4
  102.   
  103.     Keywords: GIF SATELLITE CONVERSION COLOR GREY FLEXIBLE FAST
  104.     
  105.     Convert  RIX  (640x480)  raw  satellite  data files to GIF in
  106.     Color  or  64  shades  of  grey.  Has  options for interlace,
  107.     320x200  GIF,  different  raw data sizes, and palette loading
  108.     for  color  GIFs.  Will do everything RG and VG did and a lot
  109.     more.   Allows   experimenting  with  color  images.  By  Bob
  110.     Montgomery.
  111.  
  112. It is included here as rg8.zip
  113.  
  114.